Planimetría

Planimetría

menta soporta la integración de planimetría al momento de la emisión de tickets, permitiendo que cada ticket contenga información detallada sobre la ubicación del asiento dentro del evento. Para lograr esta integración, es necesario enviar información adicional en cada ticket durante el proceso de creación. Esta información debe ser incluida dentro de ticket.props.seating.

Ejemplo de Integración

Para crear tickets con información de planimetría, debes utilizar el siguiente endpoint:

cURL

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando cURL.

    curl -X POST 'https://api.mentatickets.com/v1/tickets'
    -H 'Authorization: YOUR_API_KEY'
    -H 'Content-Type: application/json'
    --data-raw '[
        {
            "ticketOptionId": "0001",
            "showId": "4726",
            "externalReferenceEventId": "the-lion-king-broadway",
            "buyer": "buyer@emaildomain.com",
            "ticketId": "111",
            "ticketAccess": {
                "type": "URL",
                "locator": "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png",
                "status": "LOCKED"
            },
            "props": {
                "seating": {
                    "row": "A",
                    "seat": "12",
                    "section": "VIP",
                    "door": "North",
                    "image": "https://example.com/seating-image.png"
                }
            }
        }
    ]'

Python

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando Python.

import requests
import json

url = "https://api.mentatickets.com/v1/tickets"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json",
}

ticketOptionId = "0001"
showId = "4726"
externalReferenceEventId = "the-lion-king-broadway"
buyer = "buyer@emaildomain.com"
ticketId = "111"
ticketAccessType = "URL"
locator = "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png"
status = "LOCKED"

data = [
    {
        "ticketOptionId": ticketOptionId,
        "showId": showId,
        "externalReferenceEventId": externalReferenceEventId,
        "buyer": buyer,
        "ticketId": ticketId,
        "ticketAccess": {
            "type": ticketAccessType,
            "locator": locator,
            "status": status,
        },
        "props": {
            "seating": {
                "row": "A",
                "seat": "12",
                "section": "VIP",
                "door": "North",
                "image": "https://example.com/seating-image.png"
            }
        }
    }
]

response = requests.post(url, headers=headers, data=json.dumps(data))

Java

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando Java.

import okhttp3.*;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.get("application/json; charset=utf-8");

String ticketOptionId = "0001";
String showId = "4726";
String externalReferenceEventId = "the-lion-king-broadway";
String buyer = "buyer@emaildomain.com";
String ticketId = "111";
String ticketAccessType = "URL";
String locator = "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png";
String status = "LOCKED";

String json = String.format("""
        [
            {
                "ticketOptionId": "%s",
                "showId": "%s",
                "externalReferenceEventId": "%s",
                "buyer": "%s",
                "ticketId": "%s",
                "ticketAccess": {
                    "type": "%s",
                    "locator": "%s",
                    "status": "%s"
                },
                "props": {
                    "seating": {
                        "row": "A",
                        "seat": "12",
                        "section": "VIP",
                        "door": "North",
                        "image": "https://example.com/seating-image.png"
                    }
                }
            }
        ]
        """, ticketOptionId, showId, externalReferenceEventId, buyer, ticketId, ticketAccessType, locator, status);

RequestBody body = RequestBody.create(JSON, json);
Request request = new Request.Builder()
        .url("https://api.mentatickets.com/v1/tickets")
        .post(body)
        .addHeader("Authorization", "YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

PHP

A continuación les brindamos un ejemplo de cómo notificar a menta de la emisión de un ticket, con datos ficticios, utilizando PHP.

<?php
$url = "https://api.mentatickets.com/v1/tickets";
$headers = array(
    "Authorization: YOUR_API_KEY",
    "Content-Type: application/json",
);

$data = array(
    array(
        "ticketOptionId" => "0001",
        "showId" => "4726",
        "externalReferenceEventId" => "the-lion-king-broadway",
        "buyer" => "buyer@emaildomain.com",
        "ticketId" => "111",
        "ticketAccess" => array(
            "type" => "URL",
            "locator" => "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png",
            "status" => "LOCKED"
        ),
        "props" => array(
            "seating" => array(
                "row" => "A",
                "seat" => "12",
                "section" => "VIP",
                "door" => "North",
                "image" => "https://example.com/seating-image.png"
            )
        )
    )
);

$json_data = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Respuesta JSON

{
    "status": 200,
    "data": [{TICKETDATA}],
    "errors": null
}

Parámetros de seating

Campo	Tipo de Dato	Descripción	Ejemplo
row	String	Fila en la que se encuentra el asiento.	"A"
seat	String	Número de asiento.	"12"
section	String	Sección en la que se encuentra el asiento.	"VIP"
door	String	Puerta de entrada correspondiente.	"North"
image	String	URL de la imagen que muestra la ubicación del asiento.	"https://example.com/seating-image.png"

Para mas información detallada de Ticket y Seating diríjase a la sección de datos de ticket